feat(commands): use positional args for org/project selection by BYK · Pull Request #155 · getsentry/cli

BYK · 2026-02-02T17:30:45Z

Summary

Replace verbose --org and --project flags with GitHub-style positional arguments for issue list and project list commands, inspired by the gh CLI.

Before:

sentry issue list --org sentry --project cli
sentry project list --org sentry

After:

sentry issue list sentry/cli     # explicit org and project
sentry issue list sentry/        # all projects in org  
sentry issue list cli            # find project across all orgs
sentry project list sentry       # list projects in org

Changes

Add parseOrgProjectArg() utility for parsing <org>/<project> patterns
Add findProjectsBySlug() API function to search projects across orgs
Refactor issue list to use positional argument instead of flags
Refactor project list to use positional argument instead of flag
Change cross-org collision alias separator from : to / (e.g., o1/d instead of o1:d)
Update help text and error messages
Add tests for new functionality

Breaking Changes

--org and --project flags removed from sentry issue list
--org flag removed from sentry project list

Replace --org and --project flags with GitHub-style positional arguments for issue list and project list commands. New syntax: - `sentry issue list <org>/<project>` - explicit target - `sentry issue list <org>/` - all projects in org - `sentry issue list <project>` - find project across orgs - `sentry project list <org>` - list projects in org Also changes cross-org collision aliases from colon to slash separator (e.g., `o1/d` instead of `o1:d`) for consistency. BREAKING CHANGE: --org and --project flags removed from issue list and --org flag removed from project list commands.

github-actions · 2026-02-02T17:30:59Z

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

New Features ✨

(commands) Use positional args for org/project selection by BYK in #155

(feedback) Add command to submit CLI feedback by betegon in #150
(telemetry) Add is_self_hosted tag by BYK in #153
(upgrade) Add self-update command by betegon in #132
Add update available notification by BYK in #151

Bug Fixes 🐛

(telemetry) Capture command errors to Sentry by betegon in #145
Update docs URL in help output by betegon in #149

Documentation 📚

(upgrade) Add documentation for upgrade command by betegon in #152
Update README and AGENTS.md by betegon in #148

Internal Changes 🔧

Move feedback and upgrade under sentry cli command by BYK in #154

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-02-02T17:31:26Z

Codecov Results 📊

✅ Patch coverage is 97.92%. Project has 1959 uncovered lines.
✅ Project coverage is 69.68%. Comparing base (base) to head (head).

Files with missing lines (28)

File	Patch %	Lines
`human.ts`	31.87%	⚠️ 682 Missing
`resolve-target.ts`	26.39%	⚠️ 251 Missing
`oauth.ts`	25.10%	⚠️ 194 Missing
`upgrade.ts`	39.76%	⚠️ 153 Missing
`api-client.ts`	73.64%	⚠️ 141 Missing
`resolver.ts`	3.23%	⚠️ 120 Missing
`errors.ts`	5.94%	⚠️ 95 Missing
`migration.ts`	47.44%	⚠️ 82 Missing
`api.ts`	89.80%	⚠️ 47 Missing
`seer.ts`	75.54%	⚠️ 45 Missing
`seer.ts`	79.87%	⚠️ 30 Missing
`preload.ts`	39.02%	⚠️ 25 Missing
`version-check.ts`	76.00%	⚠️ 18 Missing
`detector.ts`	87.79%	⚠️ 16 Missing
`schema.ts`	64.10%	⚠️ 14 Missing
`auth.ts`	94.78%	⚠️ 7 Missing
`feedback.ts`	84.21%	⚠️ 6 Missing
`upgrade.ts`	93.83%	⚠️ 5 Missing
`utils.ts`	97.60%	⚠️ 4 Missing
`index.ts`	95.06%	⚠️ 4 Missing
`colors.ts`	91.84%	⚠️ 4 Missing
`telemetry.ts`	97.20%	⚠️ 4 Missing
`env-file.ts`	97.17%	⚠️ 3 Missing
`sentry-urls.ts`	88.00%	⚠️ 3 Missing
`alias.ts`	98.56%	⚠️ 2 Missing
`project-aliases.ts`	97.40%	⚠️ 2 Missing
`java.ts`	97.22%	⚠️ 1 Missing
`parser.ts`	98.63%	⚠️ 1 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    69.39%    69.68%    +0.29%
==========================================
  Files           56        56         —
  Lines         6416      6462       +46
  Branches         0         0         —
==========================================
+ Hits          4452      4503       +51
- Misses        1964      1959        -5
- Partials         0         0         —

Generated by Codecov Action

src/commands/issue/list.ts

src/commands/project/list.ts

src/lib/alias.ts

src/lib/api-client.ts

src/lib/resolve-target.ts

- Fix JSDoc cross-org example notation (org1:dashboard -> org1/dashboard) - Add -n short-hand flag for --limit in project list - Simplify map callback in project list - Change internal alias map key notation from : to / - Simplify findProjectsBySlug filter pattern - Remove ASCII art section dividers from resolve-target.ts - Add ProjectSpecificationType constant for discriminated union - Change /cli handling from auto-detect to project-search - Add prohibited comment styles rule to AGENTS.md

github-actions · 2026-02-02T19:04:17Z

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/pr-preview/pr-155/
Built to branch `gh-pages` at 2026-02-02 19:08 UTC. Preview will be ready when the GitHub Pages deployment is complete.

- Update project list tests to use positional org arg instead of --org flag - Update issue list tests to use org/project positional format - Regenerate SKILL.md

docs/src/content/docs/commands/issue.md

plugins/sentry-cli/skills/sentry-cli/SKILL.md

src/commands/project/list.ts

- Add placeholder properties to positional args for better help text - Add shortcut aliases: -q for query, -s for sort, -n for limit (issue list) - Add shortcut aliases: -p for platform (project list) - Add status filtering examples to issue docs (via --query) - Regenerate SKILL.md with proper argument names

- Add tests for ProjectSpecificationType constant values - Add tests for findProjectsBySlug function with various scenarios - Test handling of multiple orgs with matching projects - Test empty results when no projects match - Test graceful handling of 403 errors (permission denied)

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

src/commands/project/list.ts

test/lib/resolve-target.test.ts

- Remove ProjectSpecificationType tests (testing constants is useless) - Fix footer tip to show correct project view syntax

src/commands/issue/list.ts

BYK requested a review from betegon February 2, 2026 17:34

BYK commented Feb 2, 2026

View reviewed changes

fix: update multiregion E2E tests to use positional args

3011567

- Update project list tests to use positional org arg instead of --org flag - Update issue list tests to use org/project positional format - Regenerate SKILL.md

BYK commented Feb 2, 2026

View reviewed changes

docs/src/content/docs/commands/issue.md Show resolved Hide resolved

plugins/sentry-cli/skills/sentry-cli/SKILL.md Outdated Show resolved Hide resolved

src/commands/project/list.ts Outdated Show resolved Hide resolved

BYK marked this pull request as ready for review February 2, 2026 20:29

BYK added 2 commits February 2, 2026 20:32

cursor bot reviewed Feb 2, 2026

View reviewed changes

src/commands/project/list.ts Outdated Show resolved Hide resolved

BYK commented Feb 2, 2026

View reviewed changes

test/lib/resolve-target.test.ts Outdated Show resolved Hide resolved

fix: remove useless constant tests and fix project view tip text

c08958c

- Remove ProjectSpecificationType tests (testing constants is useless) - Fix footer tip to show correct project view syntax

sentry bot reviewed Feb 2, 2026

View reviewed changes

src/commands/issue/list.ts Show resolved Hide resolved

BYK merged commit b49386c into main Feb 2, 2026
26 of 34 checks passed

BYK deleted the feat/positional-org-project-args branch February 2, 2026 23:11

sentry-release-bot bot mentioned this pull request Feb 2, 2026

publish: getsentry/cli@0.6.0 getsentry/publish#7046

Closed

3 tasks

BYK mentioned this pull request Feb 3, 2026

feat(issue): replace --org/--project flags with <org>/ID syntax #161

Merged

Uh oh!

Conversation

BYK commented Feb 2, 2026

Summary

Changes

Breaking Changes

Uh oh!

github-actions bot commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

New Features ✨

Bug Fixes 🐛

Documentation 📚

Internal Changes 🔧

Uh oh!

github-actions bot commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Results 📊

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Built to branch gh-pages at 2026-02-02 19:08 UTC. Preview will be ready when the GitHub Pages deployment is complete.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions bot commented Feb 2, 2026 •

edited

Loading

github-actions bot commented Feb 2, 2026 •

edited

Loading

github-actions bot commented Feb 2, 2026 •

edited

Loading

Built to branch `gh-pages` at 2026-02-02 19:08 UTC.
Preview will be ready when the GitHub Pages deployment is complete.